home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / libelf / elf_rand.z / elf_rand
Encoding:
Text File  |  1998-10-30  |  4.4 KB  |  66 lines
  1.  
  2.  
  3.  
  4. EEEELLLLFFFF____RRRRAAAANNNNDDDD((((3333EEEE))))                                                      EEEELLLLFFFF____RRRRAAAANNNNDDDD((((3333EEEE))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd - random archive member access
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_cccc [_f_l_a_g ...] _f_i_l_e ...  _----_llll_eeee_llll_ffff [_l_i_b_r_a_r_y ...]
  13.  
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  15.      _ssss_iiii_zzzz_eeee______tttt _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd_((((_EEEE_llll_ffff _****_eeee_llll_ffff_,,,, _ssss_iiii_zzzz_eeee______tttt _oooo_ffff_ffff_ssss_eeee_tttt_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd, _eeee_llll_ffff______nnnn_eeee_xxxx_tttt, and _eeee_llll_ffff______bbbb_eeee_gggg_iiii_nnnn manipulate simple object files and
  19.      archives.  _e_l_f is an ELF descriptor previously returned from _eeee_llll_ffff______bbbb_eeee_gggg_iiii_nnnn.
  20.  
  21.      _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd provides random archive processing, preparing _e_l_f to access an
  22.      arbitrary archive member.  _e_l_f must be a descriptor for the archive
  23.      itself, not a member within the archive.  _o_f_f_s_e_t gives the byte offset
  24.      from the beginning of the archive to the archive header of the desired
  25.      member.  See _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_ssss_yyyy_mmmm(3E) for more information about archive member
  26.      offsets.  When _eeee_llll_ffff______rrrr_aaaa_nnnn_dddd works, it returns _o_f_f_s_e_t.  Otherwise it returns
  27.      0, because an error occurred, _e_l_f was null, or the file was not an
  28.      archive (no archive member can have a zero offset).  A program may mix
  29.      random and sequential archive processing.
  30.  
  31. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  32.      An archive starts with a ``magic string'' that has _SSSS_AAAA_RRRR_MMMM_AAAA_GGGG bytes; the
  33.      initial archive member follows immediately.  An application could thus
  34.      provide the following function to rewind an archive (the function returns
  35.      -1 for errors and 0 otherwise).
  36.  
  37.           _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_aaaa_rrrr_...._hhhh_>>>>
  38.           _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_llll_iiii_bbbb_eeee_llll_ffff_...._hhhh_>>>>
  39.  
  40.           _iiii_nnnn_tttt
  41.           _rrrr_eeee_wwww_iiii_nnnn_dddd_eeee_llll_ffff_((((_EEEE_llll_ffff _****_eeee_llll_ffff_))))
  42.           _{{{{
  43.                   _iiii_ffff _((((_eeee_llll_ffff______rrrr_aaaa_nnnn_dddd_((((_eeee_llll_ffff_,,,, _((((_ssss_iiii_zzzz_eeee______tttt_))))_SSSS_AAAA_RRRR_MMMM_AAAA_GGGG_)))) _====_==== _SSSS_AAAA_RRRR_MMMM_AAAA_GGGG_))))
  44.                           _rrrr_eeee_tttt_uuuu_rrrr_nnnn _0000_;;;;
  45.                   _rrrr_eeee_tttt_uuuu_rrrr_nnnn _----_1111_;;;;
  46.           _}}}}
  47.  
  48. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  49.      _eeee_llll_ffff(3E), _eeee_llll_ffff______bbbb_eeee_gggg_iiii_nnnn(3E), _eeee_llll_ffff______gggg_eeee_tttt_aaaa_rrrr_ssss_yyyy_mmmm(3E), _eeee_llll_ffff______nnnn_eeee_xxxx_tttt(3E), _aaaa_rrrr(4).
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.